跳到主要内容

OpenClaw OLED显示教程

开始前请先完成 使用前准备 目录下的 [01-外设硬件配置]、[02-openclaw Ajetson-KEY配置]、[03-openclaw切换模型]、[04-AI语音交互配置]、[05-三种对话方案配置测试]。如果当前只使用 TUI / 飞书，可以先跳过 04。本文默认基础环境已经准备完成，只展开 OLED 相关内容。

1. 教程目标​

本文通过 OLED 外设展示 OpenClaw 的自然语言控制能力。完成本教程后，读者可以：

  • 了解 OpenClaw 控制 OLED 显示的基本思路

  • 通过飞书、TUI、语音代码三种方式和 OpenClaw 对话

  • 完成四个 OLED 案例：文字显示、指标显示、天气卡片、动画展示

  • 理解从“用户输入”到“屏幕显示”的完整链路

2. 硬件准备​

  • OpenClaw 主控板

  • OLED 显示屏 [默认 SSD1306 128x32 / I2C 地址 0x3C]

  • [可选] 麦克风模块

  • 接线图

image-20260427181036461

3. 软件准备​

教程中会用到的代码入口

  • 底层驱动代码：/home/jetson/hardware_hal_demo/

  • OLED 控制命令：/home/jetson/hardware_hal_demo/oled

  • 温湿度联动显示：/home/jetson/hardware_hal_demo/dht_oled

  • 语音入口：/home/jetson/voice_to_openclaw/src/main.py

其中 oled 工具已经支持下面几类能力：

  • 显示文字 text

  • 显示图片 image

  • 显示动画 animation

  • 显示天气卡片 weather

  • 清屏 clear

如果只是想快速把温湿度读数显示到 OLED，也可以直接使用 dht_oled。

dht_oled #显示温湿度数据到oled oled text \-- text '你好，世界' #显示文本 oled weather \-- location '深圳' \-- condition '晴' \-- temperature '26°C' \-- humidity '57%' #天气卡片 oled image \-- path ~/ hardware_hal_demo / assets / oled / mountain_photo_128x32 . png #显示图片 oled animation \-- path ~/ hardware_hal_demo / assets / oled / sunrise_anim_128x32 . gif #显示gif动画 oled clear # 清屏

注意：其中的gif和图片显示可以叫ai生成128x32分辨率的，然后放到这个路径下~/hardware_hal_demo/assets/oled/

其他更多命令可以看这个文件夹下的md文档，

xxxxxxxxxx / home / jetson / hardware_hal_demo / README . md

如果底层命令可以正常执行，说明硬件和jetson主板链接正常、通信正常。

4. 测试OLED显示​

开始当前教程前，请先完成一次 openclaw tui 基础对话自检；如果还没做，先看 [05-三种对话方案配置测试]。确认 OpenClaw 能正常回复后，再进入 OLED 专项测试。

终端输入以下命令进入 TUI：

xxxxxxxxxx openclaw tui

image-20260529190959032

终端可以尝试输入下面内容：

  • 在 OLED 上显示“你好，OpenClaw”

  • 在屏幕上显示“今天开始学习 OLED”

  • 清空 OLED 屏幕

  • 在 OLED 上显示当前状态“System OK”

image-20260427184231001

5. 和 OpenClaw 对话的三种方案​

方案适合场景优点建议定位
飞书远程控制、课堂演示接入方便，适合多人体验展示“远程自然语言控制”
TUI本地调试、命令验证最直接、最容易排错先跑通控制链路
语音代码语音交互、完整 AI 体验最贴近真实对话体验作为最终演示方案

如果选配了AI语音模块+扬声器，飞书对话、tui、whatsapp对话需要播报openclaw回复的内容，可以终端运行下面的程序，ai语音模块对话不需要重复运行

  • 修改是否打开播报参数

xxxxxxxxxx /home/jetson/voice_to_openclaw/.env xxxxxxxxxx ENABLE_TTS = true #这个参数就是控制是否播报，修改完保存，终端运行下面程序

  • 终端输入

xxxxxxxxxx cd ~/ voice_to_openclaw source . venv / bin / activate python \- m src . openclaw_session_tts

image-20260529190948629

5.1 飞书方案​

飞书接入步骤请直接参考 [05-三种对话方案配置测试]，本节只保留适合 OLED 教程的对话示例。

创建好之后可以直接对话，例如：

  • 在 OLED 上显示“欢迎来到 OpenClaw”

  • 帮我把当前温湿度数据显示在oled上

  • 清空 OLED 屏幕

image-20260427184519886

5.2 TUI 方案​

如果已经完成第 0 篇中的 TUI 自检，直接在终端输入下面命令即可继续对话：

xxxxxxxxxx openclaw tui

5.3 语音代码方案​

xxxxxxxxxx 需要选配 ai 语音交互模块 + 扬声器

语音模块安装、环境配置和基础唤醒流程请直接参考 [04-AI语音交互配置]。唤醒之后，可以直接说出控制内容，例如：

  • 在 OLED 上显示你好

  • 把屏幕内容改成欢迎使用 OpenClaw

  • 清空屏幕

image-20260529191226711

6. 综合案例​

注意：下面都是在 openclaw tui 方式进行对话演示，你也可以自己选择飞书或语音方式来完成。

6.1 案例一：文字显示​

实验目标​

让 OLED 显示一段固定文本，用来完成最基础的屏幕控制。

效果说明​

OpenClaw 接收到指令后，会把指定文字渲染到 OLED 屏幕上。这个案例适合用来验证文字渲染、换行和屏幕刷新是否正常。

示例指令​

  • 在 OLED 上显示“你好，OpenClaw”

  • 显示“今天的任务是测试 OLED”

  • 把屏幕内容改成“System Ready”

6.2 案例二：指标显示​

实验目标​

让 OLED 以更紧凑的方式显示单行状态指标。

效果说明​

这个模式适合把温度、湿度、电量、状态值这类短信息压缩在一行里显示，更像一个简单的仪表盘读数。

示例指令​

  • 在 OLED 上显示“Temp 26C Hum 57%”

  • 把当前状态写成一行短信息

  • 把屏幕内容改成“CPU OK RAM OK”

6.3 案例三：天气卡片​

实验目标​

让 OLED 显示一个更完整的天气信息卡片。

效果说明​

屏幕上可以显示位置、天气、温度和湿度等信息。这个案例适合拿来做天气站、环境监测或者信息面板。

示例指令​

  • 在 OLED 上显示深圳晴天 26 度 湿度 57%

  • 做一张简洁的天气卡片

  • 把当前温湿度排版成卡片样式显示

6.4 案例四：动画展示​

实验目标​

让 OLED 播放图片或动画，展示更丰富的视觉效果。

效果说明​

除了静态文字以外，OLED 还可以显示位图、GIF 动画或者简单自检动画。这个案例很适合做开机页面、表情动画或者课堂演示（可以自行准备要显示的照片或者gif动画放在路径下/home/jetson/hardware_hal_demo/assets/oled）。

示例指令​

  • 在 OLED 上播放一个简单动画

  • 显示一张图标图片

  • 做一个开机欢迎动画